home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audio / alGetDevice.z / alGetDevice
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee((((3333ddddmmmm))))                                              aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alSetDevice, alGetDevice - get/set the device setting in an audio
  10.      AAAALLLLccccoooonnnnffffiiiigggg structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  16.  
  17.      iiiinnnntttt aaaallllSSSSeeeettttDDDDeeeevvvviiiicccceeee((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg,,,, iiiinnnntttt ddddeeeevvvviiiicccceeee))))
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  20.      _c_o_n_f_i_g   expects an AAAALLLLccccoooonnnnffffiiiigggg structure, the returned value of a call to
  21.               aaaallllNNNNeeeewwwwCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) or aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))).
  22.  
  23.      _d_e_v_i_c_e   expects the integer resource ID of an audio device (see
  24.               aaaallllRRRReeeessssoooouuuurrrrcccceeeessss((((3333ddddmmmm))))).
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      aaaallllSSSSeeeettttDDDDeeeevvvviiiicccceeee sets the device setting in the AAAALLLLccccoooonnnnffffiiiigggg structure _c_o_n_f_i_g.
  28.      Any audio port that you then open using _c_o_n_f_i_g will attempt to use the
  29.      device you specify.
  30.  
  31.      aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee returns the current device setting in the AAAALLLLccccoooonnnnffffiiiigggg structure
  32.      _c_o_n_f_i_g. Note that since device connections are dynamic, ports previously
  33.      opened with this AAAALLLLccccoooonnnnffffiiiigggg may no longer be connected to the given device.
  34.  
  35. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  36.      If successful, aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee returns a positive device resource ID.
  37.      Otherwise, aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee returns -1 and and sets an error number which can
  38.      be retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  39.  
  40.      aaaallllGGGGeeeettttDDDDeeeevvvviiiicccceeee can fail for the following reason:
  41.  
  42.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is invalid or null.
  43.  
  44.      If successful, aaaallllSSSSeeeettttDDDDeeeevvvviiiicccceeee returns 0. Otherwise, it returns -1 and sets
  45.      an error number which can be retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  46.  
  47.      aaaallllSSSSeeeettttDDDDeeeevvvviiiicccceeee can fail for the following reasons:
  48.  
  49.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is invalid or null.
  50.  
  51.      AAAALLLL____BBBBAAAADDDD____DDDDEEEEVVVVIIIICCCCEEEE   _d_e_v_i_c_e is invalid. Note that even though aaaallllSSSSeeeettttDDDDeeeevvvviiiicccceeee may
  52.                      succeed in setting a given device in an AAAALLLLccccoooonnnnffffiiiigggg, the
  53.                      ensuing aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt may still fail if the device does not
  54.                      exist.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      alNewConfig(3dm), alGetConfig(3dm), alOpenPort(3dm), alSetConfig(3dm),
  58.      oserror(3C)
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.